Creates a new directory.

OSErr PBDirCreateAsync (
    HParmBlkPtr paramBlock
);

paramBlock

A pointer to a basic HFS parameter block.

function result

A result code.

DISCUSSION

The relevant fields of the parameter block are:

• ioCompletion

  On input, a pointer to a completion function.

• ioResult

  On output, the result code of the function.

• ioNamePtr

  On input, a pointer to a pathname.

• ioVRefNum

  On input, a volume specification.

• ioDirID

  On input, a parent directory ID. On output, the directory ID of the new directory.

The PBDirCreateAsync function is identical to PBHCreateAsync except that it creates a new directory instead of a file. You can specify the parent of the directory to be created in ioDirID; if it’s 0, the new directory is placed in the root directory of the specified volume.The date and time of its creation and last modification are set to the current date and time.

A directory ID, unlike a volume reference number or a working directory reference number, is an SInt32 value.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)